SetConditionalFormatting(Int32,Int32,IConditionalFormattingRule[]) Method

Sets conditional formatting for a specified cell on the sheet based on specified rules.

Syntax

Visual Basic
C#

'Declaration
 
Public Overloads Sub SetConditionalFormatting( _
   ByVal row As Integer, _
   ByVal column As Integer, _
   ByVal ParamArray rules() As IConditionalFormattingRule _
)

'Usage
 
Dim instance As SheetView
Dim row As Integer
Dim column As Integer
Dim rules() As IConditionalFormattingRule
 
instance.SetConditionalFormatting(row, column, rules)

public void SetConditionalFormatting( 
   int row,
   int column,
   params IConditionalFormattingRule[] rules
)

Parameters

row: Row index
column: Column index
rules: Rules to apply for the specified cell

Example

This example creates a conditional rule.

private void Form1_Load(object sender, EventArgs e)
    {
        fpSpread1.Sheets[0].Cells[0, 0].Value = 3;
        fpSpread1.Sheets[0].Cells[1, 0].Value = 2;
        fpSpread1.Sheets[0].Cells[1, 1].Value = 10;
        fpSpread1.Sheets[0].Cells[0, 2].Value = 1;
    }

    private void button1_Click(object sender, EventArgs e)
    {
        FarPoint.Win.Spread.Model.CellRange celRange1 = new FarPoint.Win.Spread.Model.CellRange(0, 0, 3, 3);
        FarPoint.Win.Spread.ThreeColorScaleConditionalFormattingRule rule = new FarPoint.Win.Spread.ThreeColorScaleConditionalFormattingRule(Color.Aqua, Color.Bisque, Color.BlueViolet);
        fpSpread1.Sheets[0].SetConditionalFormatting(new FarPoint.Win.Spread.Model.CellRange[] { celRange1 }, rule);
        //or
        //FarPoint.Win.Spread.Model.CellRange celRange1 = new FarPoint.Win.Spread.Model.CellRange(0, 0, 3, 3);
        //FarPoint.Win.Spread.Model.CellRange celRange2 = new FarPoint.Win.Spread.Model.CellRange(0, 4, 2, 2);            
        //FarPoint.Win.Spread.ThreeColorScaleConditionalFormattingRule rule = new FarPoint.Win.Spread.ThreeColorScaleConditionalFormattingRule(Color.Aqua, Color.Bisque, Color.BlueViolet);
        //fpSpread1.Sheets[0].SetConditionalFormatting(new FarPoint.Win.Spread.Model.CellRange[] { celRange1, celRange2 }, rule);
        //or
        //FarPoint.Win.Spread.ThreeColorScaleConditionalFormattingRule three = new FarPoint.Win.Spread.ThreeColorScaleConditionalFormattingRule();
        //three.MidValue = new FarPoint.Win.Spread.ConditionalFormattingColorValue(Color.Aqua, 10, FarPoint.Win.Spread.ConditionalFormattingValueType.Number);
        //three.MinValue = new FarPoint.Win.Spread.ConditionalFormattingColorValue(Color.BlueViolet, 10, FarPoint.Win.Spread.ConditionalFormattingValueType.Number);
        //fpSpread1.Sheets[0].SetConditionalFormatting(1, 1, three);
    }

VB.NET

Private Sub Form1_Load(ByVal sender As System.Object, ByVal e As System.EventArgs) Handles MyBase.Load
        FpSpread1.Sheets(0).Cells(0, 0).Value = 3
        FpSpread1.Sheets(0).Cells(1, 0).Value = 2
        FpSpread1.Sheets(0).Cells(1, 1).Value = 10
        FpSpread1.Sheets(0).Cells(0, 2).Value = 1
    End Sub

    Private Sub Button1_Click(ByVal sender As System.Object, ByVal e As System.EventArgs) Handles Button1.Click
        Dim celRange1 As New FarPoint.Win.Spread.Model.CellRange(0, 0, 3, 3)
        Dim rule As New FarPoint.Win.Spread.ThreeColorScaleConditionalFormattingRule(Color.Aqua, Color.Bisque, Color.BlueViolet)
        FpSpread1.Sheets(0).SetConditionalFormatting(New FarPoint.Win.Spread.Model.CellRange() {celRange1}, rule)
        'or
        'Dim celRange1 As New FarPoint.Win.Spread.Model.CellRange(0, 0, 3, 3)
        'Dim celRange2 As New FarPoint.Win.Spread.Model.CellRange(0, 4, 2, 2)
        'Dim rule As New FarPoint.Win.Spread.ThreeColorScaleConditionalFormattingRule(Color.Aqua, Color.Bisque, Color.BlueViolet)
        'FpSpread1.Sheets(0).SetConditionalFormatting(New FarPoint.Win.Spread.Model.CellRange() {celRange1, celRange2}, rule)
        'or
        'Dim three As New FarPoint.Win.Spread.ThreeColorScaleConditionalFormattingRule()
        'three.MidValue = New FarPoint.Win.Spread.ConditionalFormattingColorValue(Color.Aqua, 10, FarPoint.Win.Spread.ConditionalFormattingValueType.Number)
        'three.MinValue = New FarPoint.Win.Spread.ConditionalFormattingColorValue(Color.BlueViolet, 10, FarPoint.Win.Spread.ConditionalFormattingValueType.Number)
        'FpSpread1.Sheets(0).SetConditionalFormatting(1, 1, three)
    End Sub

Requirements

Target Platforms: Windows 2000 Professional (SP4), Windows 2000 Server, Windows 2003 Server (SP1), Windows Server 2012 R2, Windows 2008, Windows XP (SP2), Windows Vista, Windows 7, Windows 8, Windows 8.1, Windows 10

Reference

SheetView Class
SheetView Members
Overload List